home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / misc / flickwerk.readme < prev    next >
Text File  |  1999-03-02  |  6KB  |  244 lines

  1. Short:    Picture mosaic creator
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (timm.mueller@darmstadt.netsurf.de)
  4. Version:  0.0.1
  5. Type:     gfx/misc
  6. Requires: os3.0 (v39), 68020
  7.  
  8.  
  9. flickwerk
  10. documentation
  11.  
  12.  
  13. introduction
  14. -------------------
  15.  
  16. flickwerk is a picture mosaic generator. it
  17. creates an approximation of a reference picture by
  18. composing it from a large number of small source
  19. pictures.
  20.  
  21.  
  22.  
  23. legal status
  24. -------------------
  25.  
  26. © by TEK neoscientists. freeware.
  27.  
  28.  
  29.  
  30. requirements
  31. -------------------
  32.  
  33. - os3.0 (v39)
  34. - 68020
  35. - guigfx.library v15
  36. - render.library v29
  37.  
  38. recommended:
  39.  
  40. - fast CPU
  41. - 24bit datatypes installed and properly working
  42. - a large number of pictures
  43.  
  44.  
  45.  
  46. warning
  47. -------------------
  48.  
  49. this software will overwrite the filecomments of
  50. all source pictures specified.
  51.  
  52. this behavior cannot be disabled. if you don't
  53. want to lose your source pictures' filecomments,
  54. you must copy these picures to another location
  55. first.
  56.  
  57.  
  58.  
  59. usage
  60. -------------------
  61.  
  62. flickwerk is a shell command. template:
  63.  
  64. flickwerk WITH=S0URCEFILES/A/M,
  65.           FR0M=REFFILE/A,
  66.           T0=0UTFILE/A,
  67.           UPDATE/S,
  68.           USEKEYS/S,
  69.           X=XSEGMENTS/N,
  70.           Y=YSEGMENTS/N,
  71.           W=PARTWIDTH/N,
  72.           H=PARTHEIGHT/N,
  73.           FX=ALLOWFLIPX/S,
  74.           FY=ALLOWFLIPY/S
  75.            
  76.            
  77. WITH=SOURCEFILES/A/M
  78. any number of files, directories, volumes. pattern
  79. matching is supported. directories will be scanned
  80. recursively. warning: any picture encountered will
  81. receive a new filecomment without further notice!
  82.  
  83. FROM=REFFILE/A
  84. reference picture to be approximated.
  85.  
  86. TO=OUTFILE/A
  87. filename of the picture to be generated. this
  88. picture will be saved in PPM format.
  89.  
  90. UPDATE/S
  91. recalculate all keys, no matter if valid keys were
  92. encountered.
  93.  
  94. USEKEYS/S
  95. do not generate new keys, only use pictures with
  96. already existing keys.
  97.   
  98. X=XSEGMENTS/N
  99. number of mosaic parts to compose the picture from
  100. (horizontally). defaults to 20.
  101.  
  102. Y=YSEGMENTS/N
  103. number of mosaic parts to compose the picture from
  104. (vertically). defaults to 20.
  105.  
  106. W=PARTWIDTH/N
  107. width of a single mosaic part. default: 40
  108.  
  109. H=PARTHEIGHT/N
  110. height of a single mosaic part. default: 30
  111.  
  112. FX=ALLOWFLIPX/S
  113. allow horizontal mirroring. note: this option will
  114. double the calculation time.
  115.  
  116. FY=ALLOWFLIPY/S
  117. allow vertical mirroring. note: this option will
  118. double the calculation time.
  119.  
  120.  
  121.   
  122. how it works
  123. -------------------
  124.  
  125. 1. key-list creation
  126.  
  127. the supplied directories will be scanned for valid
  128. pictures. any newly encountered picture will be
  129. loaded and reduced to a 360 bit key. if not
  130. already present, the key will encoded to an ascii
  131. string and written to the picture's filecomment.
  132. (valid filecomments will be simply decoded back to
  133. keys.)
  134.  
  135.  
  136. 2. selection
  137.  
  138. after building the list of keys, the reference
  139. picture will be loaded and decomposed to the
  140. specified number of mosaic segments (by default
  141. 20x20). each segment will be reduced to a 360 bit
  142. reference key. each reference key will be compared
  143. against all keys in the source list.
  144.  
  145.  
  146. 3. composition
  147.  
  148. the best matching pictures will be loaded, scaled,
  149. and inserted to their respective locations in the
  150. resulting picture. this picture is finally saved
  151. in PPM format.
  152.  
  153.  
  154.  
  155. notes
  156. ----------------------------------
  157.  
  158. - it may take many hours when you apply flickwerk
  159. to a large number of source pictures the first
  160. time. this depends on the number of pictures,
  161. their sizes, formats, the datatypes used, and the
  162. general system performance. further usage of the
  163. same source material will be much faster.
  164.  
  165. - it's a good idea to reduce the task priority of
  166. the shell process running flickwerk. use e.g.
  167. changetaskpri -3.
  168.  
  169. - the source pictures will be cropped to areas
  170. with differing pixels. this will cut off e.g.
  171. black borders.
  172.  
  173. - you should take care of the reference picture's
  174. aspect ratio. the default settings apply to an
  175. aspect ratio of 4:3. different aspect ratios
  176. require appropriate settings for
  177. PARTWIDTH/PARTHEIGHT or XSEGMENTS/YSEGMENTS.
  178.  
  179.  
  180.    
  181.  
  182. how to obtain good looking results
  183. ----------------------------------
  184.  
  185. - use a simple and contrastful image as the
  186. reference picture, e.g. a face, a logo.
  187.  
  188. - allow horizontal and vertical mirroring of the
  189. source pictures, i.e. specify the options FX and
  190. FY.
  191.  
  192. - the more source pictures you specify, the better
  193. the results you get. 'several thousands' is a good
  194. measure.
  195.  
  196. - use heterogenous, contrastful source pictures.
  197. do not include workbench patterns and pale stuff
  198. alike.
  199.  
  200. - use larger numbers for XSEGMENTS and YSEGMENTS.
  201.  
  202. - the segments are currently not scaled with
  203. interpolation. workaround: specify larger mosaic
  204. parts (PARTWIDTH/PARTHEIGHT), and scale down the
  205. output picture with an image processing software.
  206.  
  207.  
  208.  
  209. author
  210. -------------------
  211.  
  212. bifat / TEK neoscientists
  213. timm.mueller@darmstadt.netsurf.de
  214.  
  215.  
  216. ============================= Archive contents =============================
  217.  
  218. Original  Packed Ratio    Date     Time    Name
  219. -------- ------- ----- --------- --------  -------------
  220.    25968   16094 38.0% 14-Feb-99 00:55:54 +flickwerk_68020
  221.    22148   13793 37.7% 14-Feb-99 00:57:50 +flickwerk_68040
  222.     1528    1031 32.5% 14-Feb-99 00:53:10 +README.info
  223.     1871    1084 42.0% 14-Feb-99 00:53:10 +source.info
  224.      450     155 65.5% 10-Dec-98 15:01:38 +Debug.h
  225.     1121     395 64.7% 14-Feb-99 00:54:30 +defs.h
  226.     7999    1870 76.6% 13-Feb-99 00:58:58 +filelist.c
  227.     1005     366 63.5% 13-Feb-99 00:59:10 +filelist.h
  228.    13649    3776 72.3% 14-Feb-99 00:43:04 +flickwerk.c
  229.      277      73 73.6% 22-Jan-99 09:50:56 +flickwerk.h
  230.     3756    1049 72.0% 14-Feb-99 00:54:40 +global.c
  231.      515     162 68.5% 21-Jan-99 18:03:30 +global.h
  232.    11189    2870 74.3% 08-Feb-99 23:51:50 +picturekey.c
  233.     1462     436 70.1% 09-Feb-99 00:24:02 +picturekey.h
  234.     1871    1081 42.2% 14-Feb-99 00:53:14  flickwerk.info
  235.     4780    1988 58.4% 14-Feb-99 00:49:30 +README
  236.     2971    1040 64.9% 25-Jan-99 09:42:50 +scan.c
  237.      448     141 68.5% 22-Jan-99 22:47:00 +scan.h
  238.     1208     536 55.6% 14-Feb-99 00:44:42 +smakefile-optimize20
  239.     1208     539 55.3% 14-Feb-99 00:45:04 +smakefile-optimize40
  240.     6355    1456 77.0% 25-Jan-99 09:44:52 +tools.c
  241.      921     278 69.8% 21-Jan-99 11:45:08 +tools.h
  242. -------- ------- ----- --------- --------
  243.   112700   50213 55.4% 15-Feb-99 02:29:38   22 files
  244.